The Navigation Services suite greatly enhances the user experience of opening, saving and selecting documents, while giving your application new capabilities without customizing dialogs. Some of the benefits of adopting Navigation Services APIs for your application include:
- new movable, resizable, appearance-aware Open & Save dialogs
- easier navigation: list view with disclosure triangles, recent items, favorite items, etc
- built-in access to AppleTalk and AppleShare servers
- built-in transparent file format translation
More information on the features of the new dialogs may be found in the Navigation Services developer note.
How to use Navigation Services
Navigation Services is released as a fat CFM shared library. It can be used to build PowerPC applications as well as 68K applications, using CFM-68K or classic 68K runtime models.
To use Navigation Services in your application:
- #include "Navigation.h"
Then link with:
- PowerPC: Navigation shared library
- CFM-68K: Navigation shared library
- classic 68K: Navigation.o / Navigation.far.o
On 68K systems, replace the OpenTransportLib.68k in your Extensions folder with the one included in this SDK.
To use Navigation Services, make sure that the Navigation shared library is installed in the Extensions folder of your machine.
For sample code, refer to the SimpleText or Sampler application folders found in the SDK.
Limitations and known problems
This is an alpha build and is known to contain bugs. Do not use this software for critical tasks or on machines containing information you cannot afford to lose.
Navigation Services may crash under low memory conditions, so make sure you increase the memory partition of any application that uses Navigation Services.